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Introduction 


The OSI 6500 Assembler/Editor provides assembly language programming | 


capability that is fully format compatible with the standard MOS Technology 
assembly language. Therefore, all existing standard 6500 programs can be 
directly assembled without changes and the OSI Assembler is compatible with 
all existing MOS Technology 6500 documentation. The Assembler is easy to 
use and provides your choice of a full assembly listing, an errors-only 
listing, an object tape listing or an assembly of machine code directly to 
memory. The Editor provides easy-to-use, line-oriented file entry and 
editing with commands for selective source file printout, deletion of lines, 
re-numbering of lines and unlimited insertions between existing lines. 

The 6500 Assembler/Editor is offered in a number of different versions 
for various system configurations. Refer to the appropriate appendix for 
information relevant to your particular version. 

This manual thoroughly explains the operation and usage of the Assembler/ 
Editor and provides a summary of the MOS Technology 6500 assembly language. 
For a detailed explanation of 6500 assembly language programming, the reader 
is referred to one of the available texts on the subject such as the MOS 
Technology Programming Manual or "How to Program Microcomputers" by William 
Barden. 
Elements of the Assembly Language 

The following elements of the assembly language are first defined. 
Labels 

Labels are used in assembly language programs to identify program points - 
specific locations in a program where an instruction sequence begins, a constant 
is located, or a variable is to be stored that needs to be referenced elsewhere 
in the program. The use of a label at a program point provides the means to 


refer to the program point mnemonically, or by name, rather than by the machine a 
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address of the location. The use of a label also permits the Assembler to 
automatically update all references to a program point when its machine 
address changes due to changes in the program. A label may also be used 
Synonomously for a numerical value which is not a program point. Such a 
label is often called a symbol. 
A label consists of one to six characters from the set: 
A-Z 
9-9 
‘ 
The first character in a label must be a letter. The reserved names A, X, 
Y, S and P may not be used as labels. 
There is one predefined label, "*", which refers to the current value 


of the location counter throughout an assembly. 


Examples: START * 
TEN.1 LABEL: 
TABLE A$B 
Constants 


Constants are used in assembly language programs for numerical values 
and character strings. 

Although numerical constants are generally expressed internally in the 
computer in binary, the Assembler permits them to be expressed in binary, 
octal, hexidecimal or decimal. The absence of a prefix symbol indicates a 
decimal value. The other number bases are indicated by the prefixes: 

% for binary 
@ for octal 


$ for hexidecimal 


Numerical constants are always unsigned, positive numbers. They are limited 
in magnitude to 255 (decimal) if they are to be represented by a single byte 
or to 65535 if a double byte (or word). 
Examples: 1999 016499 
4191191 $FACE 
Character string constants are represented internally in the American 
Standard Code for Information Interchange (ASCII). The Assembler accepts 
character string constants as any sequence of printing ASCII characters pre- 
ceeded by and followed by a single quote mark (an apostrophe). If an apos- 
trophe is to be included within the string, two successive apostrophes must 
be used. The Assembler also accepts a single character preceeded by an 
apostrophe as the operand of an immediate mode instruction. (See Instruction 
Addressing Modes - Immediate) 
Examples: ‘THIS IS A CHARACTER STRING CONSTANT ' 
@."&#%$' 


'12 dozen' 


Expressions 


_ An expression is a sequence of one or more labels and/or numerical 
constants separated by the arithmetic operators +, -, * and / (for add, 
Subtract, multiply and divide). An expression defines a value in terms 
of an algebraic expression that is evaluated at assembly time (not program 
execution time). The Assembler evaluates expressions strictly left to 
right; there is no operator precedence in expression evaluation and 


parentheses may not be used to alter the order of operations. 


Examples: START TABLE-1 
START+1 9-1] 
SIZE/256*256 %101+@19*15/$12 
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Assembler Statements 


The Assembler recognizes three types of statements: 
- Comment Statements 
- Instruction Statements 
- Directive Statements 
Each statement is one line of assembler source code. 
Comment Statements 
Comment statements are included in assembly language programs to provide 
headings and other explanatory information. They, in no way, affect the machine 
code generated by the Assembler. 
A comment statement consists of a semicolon as the leftmost, non-blank 
character followed by any commentary whatever. 
Examples: ; CONVERSION PROGRAM 
; **Output Subroutine** 
Instruction Statements 
Instruction statements specify a 6500 assembly language instruction 
mnemonic or "opcode". The opcode may be preceeded by a label and must be 
followed by an appropriate "operand" corresponding to the instruction 
addressing mode as described below. The operand may be followed by any 
commentary desired. Thus, the fields in an instruction statement are: 
(label ) (opcode) (operand) (comment ) 
where the (label) and (comment) fields are optional and the (operand) is 
as appropriate to the instruction addressing mode. At least one space 


must exist between the fields. 


Examples: START LDA VALUE GET STARTING VALUE 
| STX XTEMP SAVE X-REG 
TES! SEC 


whe 


Instruction Addressing Modes 
The 6500 Assembler recognizes eight different assembly language address-\ / 


ing modes. These are further analyzed at assembly time and result in the 
choice of an instruction from one of the thirteen machine language addressing 
modes. Each assembly language addressing mode has a unique operand syntax. 
The form of each is as defined below. 
Implied 

The implied addressing mode has no operand. The operand on which the 


instruction is to operate is implied by the instruction opcode itself. 


Examples: CLC PHA 
INX RTS 
BRK TYA 
Accumulator 


The accumulator addressing mode is used to specify the accumulator 
register as the operand. 
Operand Form: A 
Examples: LSRA 
ROR A 
Immediate 
The immediate addressing mode is used to specify a single byte constant 
as the operand. 


Operand Form: #expression or single character constant optionally 
followed by an expression 


Examples: LDA #9 LDX #99-%191 
ADC #'A CMP #'?-] 
AND #$8F LDA #LABEL/256 
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Symbolic 
The symbolic addressing mode is used to reference an absolute (above 


page zero) or page zero memory location. When a symbolic operand is 
evaluated, the Assembler may choose either an absolute or a page zero 
machine language instruction as required by the operand value. If the 
opcode is that of a branch instruction, the relative addressing mode is 
always used. 


Operand Form: expression 


Examples: LDA VALUE CMP LIMIT-1 
ASL BITS+2 SBC SIZE/2+START 
STA @ JMP START 
BNE NEXT BVS OVRF 


Note: If any label in a symbolic operand expression is undefined when 
that operand is encountered during pass one of an assembly and the instruction 
has both zero page and absolute addressing modes, the Assembler assumes that 
the absolute addressing mode and thus a two byte operand will be required. If 
on pass two the operand evaluates to a page zero location and one byte could 
be used, a warning error is printed noting a forward reference to page zero 
memory (error 19). This is not a serious error and only indicates that an 
extra byte was used. 
Indexed 

The indexed addressing mode is used to reference an absolute (above 
page zero) or a page zero location as specified by the instruction operand 
plus the contents of the specified index register at instruction execution 
time. When an indexed operand is evaluated, the Assembler may choose either 
an absolute or a page zero machine language instruction as required by the 
operand value. | 

Operand Form: expression,X or 


expression, Y 


stbyes 


Examples: LDA TABLE-1,X LOX LIST s¥ 
STA MARK,Y LDY STACK,X 
DEC 9,x ROR DIVISR,X 
ASL TWO,X STX ZIP,Y 


See the note under Symbolic. 
Indexed Indirect 
The indexed indirect addressing mode is used to reference a location as 
specified by the address in the two page zero locations indicated by the 
instruction operand plus the contents of the X index register at instruction 
execution time. 
Operand Form: (expression,X) 
Examples: LDA (LIST,X) CMP (LIMITS+2,X) 
STA (ADRS,X) ORA (BUFFER,X) 
Indirect Indexed 
The indirect indexed addressing mode is used to reference a location as 
specified by the address formed by adding the Y index register to the address 
in the two page zero locations indicated by the instruction operand. 
Operand Form: (expression) ,Y 
Examples: LDA (LIST),Y CMP (LIMITS+2) ,Y 
STA (ADRS) ,Y ORA (BUFFER) ,Y 
Indirect 
The indirect addressing mode is used to reference a location as specified 
by the address in the two locations indicated by the instruction operand. 
Operand Form: (expression) 
Examples: JMP (RETURN) 
JMP (RETABL+RND) 
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[ Not all 6500 instructions can have all addressing modes. The table on the — 
m A following page defines for each instruction the available assembly language 


and machine code level addressing modes. 
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General 


SHLIC 


Bit 
Test 


Compare 
Index 


Decrement/ 
Inerement 


Branch 


Implied 


Addressing Modes AC IM Symbolic Indexed Indirect 
MAIS PONE TOPE AE, ERLE EERE AAT 


Table lL 


6500 Instruction Addressing Modes ( ) 


Machine Language 
Addressing Modes 


ADC AND CMP EOR | 
LDA ORA SBC x |xilx 


STA 


BCC BCS BEQ BMI | 


BNE BPL BVC BVS | 


BRK NOP RTI RTS 
CLC CLD CLI CLV | ree 
DEX DEY INX INY | a cated 
PHP PLA PLP 
SED SEI | 
TAY TSX | 
| 


TYA TXS 


AC - Accumulator Abs - Absolute 
IM - Immediate Rel = Relative ( ) 


ZP - Zero Page In - Indirect 
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Directive Statements 

Directive statements specify an assembler directive (as opposed to a 
6500 instruction). Directives are used to define numerical and character 
string constants, to set the program location origin, reserve space and 
equate labels to values. All directives begin with a period and appear 
in the opcode field of a directive statement. The directive may be pre- 
ceeded by a label and must be followed by an appropriate operand. The 
operand may be followed by any commentary desired. Thus, the fields in 
a directive statement are: 

(label) (directive) (operand) (comment) 

where the (label) and (comment) fields are optional and the (operand) is 
as appropriate to the directive. At least one space must exist between 
fields. 


The following directives are provided in the 6500 Assembler: 


.BYTE Directive 


This directive is used to generate single byte numerical constants 
and character string constants of any length. 
Qperand Form: expression or character string constant, ... 
Evans: ~BYTE @ 
-BYTE %19,@10,10,$10,'1', TEN 
MESG: «BYTE: “MESSAGE *,2555° 2" 4$0 
| «BY LE SILE/ ZF) 


-WORD Directive 


This directive is used to generate two byte numerical constants in the 


low, high order by byte used for machine addresses. 


Operand Form: expression, ... 


Sie 


Examples: .WORD $ABCD 
»WORD START ,START+2 
»WORD 12,109,1900, 19022 
.DBYTE Directive 
This directive is used to generate two byte numerical constants in 
high, low order by byte. 
Operand Form: expression, ... 
Examples: .DBYTE $ABCD 
.DBYTE START ,START+2 
-DBYTE 19,192,190, 1D002 


Note: Any other character string following a period such as .END, is 
ignored by the Assembler. 


Equals (=) Directive 

This directive is used to set the program location origin, reserve 
Space and equate labels to values. Each of these operations uses a distinct 
statement form and is shown separately below. 
Setting the Program Location Origin 

Statement Form: * = expression 

Examples: * = $0390 

START 


* 


* 


LAST+15 


Reserving Space — 


Statement Form: label * = *+texpression (label is optional) or 


label * = expressiont* 
Examples: * = *+] 
TABLE * 
ARRAY * = XDIM*YDIM+* 
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Equating Labels to Values 


Statement Form: label = expression 
1p 
START = $8C90 


Examples: TEN 


SIZE = XDIM*YDIM 
Note: In all forms of the equals directive, all labels used in an expression 
must be defined previously in the assembler source file or the Assembler 
cannot determine the location of subsequent labels during pass one of the 


assembly. This can result in “label previously defined" errors (error 12) 
for the subsequent labels during pass two. 


Assembly Commands 
The Assembler has four assemble commands: 
A or A® gives a fully assembly listing 
Al gives an errors-only listing 
A2 gives an object tape listing 
A3 assembles object code directly to memory 
Full Assembly Listing - A 
The A or A® command gives a full assembly listing including, from left 
to right, for each line of assembly source code: 
- source code line number 
- program location 
- object (machine) code - zero to three bytes 
- source code 
If any errors were detected in the source code, pointer(s) to the error 
and the appropriate error number(s) appear after the above line. The machine 
code generated in the case of an error depends on the type of error, but 
generally, is either the appropriate opcode byte with a zero operand or three 
NOP bytes to facilitate patching without requiring reassembly. 


See Figure 1. 
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38 i ENTR'?: Nc PARARANS 
49 ; EXIT: STUFF SWAPPED 
28 i A SAVED 
68 ‘ PURE PROCEDURE 
ro j 
SB 4706 * = $4700 
98 i 
1B 3 SWAP STORAGE 
116 4966 SWAPE « = «+512 PAGE &@. 1 
128 i 
1368 3 TEMP STORAGE 
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E# er 
198 4965 68 PLA 
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248 4917 BCeadS LOY SWAPB+2S56, « PAGE 1 BYTES 
218 491A ERERER STA SWAPB+256, 5 
mace sense semen sense sian mee execs sous cote ee meen cute <ecus creme quote sinte SOOO) suuSt sonny SuGGD OUED GERD GGG <EnND com=n Comms OSS SAH Gute Go==t sne=D some tne cum GUtte cutc> exnen comme sone t 
E# 3 
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338 491E 93DGH61 STA 256, & 
348 ; 
256 4921 B560 LDA @. * THEN INTERCHNAGE 2 
366 4923 BC@Hd? LDY SWAPB: * FAGE @ BYTES 
3r8 4926 9Dpe64r STA SWAPB: x 
388 4929 938 TYA : 
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490 492C E& INX 
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Full Assembly Listing 
ey be 


C 


VY 


§ 


eo oe oO OL ee Es ee ee 


| aa 


= 


Ss EF 


mn He FE HE EE GB 


Ss EF ie 


Cy 


Errors-Only Listing - Al 


The Al command produces the same output described above for the full 
assembly listing, but does so only for source lines which contain detected 
assembly errors. 


See Figure 2. 


Object Tape Listing - A2 


The A2 command produces an object tape listing in the standard format 
which includes for each object tape "record": 
- start of record character (a semicolon) 
- number of data bytes in record up to 24 (18 hex) 
- address (or location) of data bytes (4 hex digits) 
- values of data bytes (2 hex digits each) 
- record checksum (4 hex digits) - 16 bit sum modulo 65536 
- carriage return, line feed, nulls 
See Figure 3. 
Assembly to Memory - A3 
The A3 command produces no printed output, but places the:object code 
resulting from the assembly directly into RAM at the specified program location, 
plus any offset previously entered with the M (Memory Offset) command. 
This command must be used with caution as there is no protection against 


the object code overwriting the Assembler or other needed RAM. 


as, 


AL 
158 4902 
E# 4 
198 492 
E# 5 
24a 490D 
E# 18 
218 491A 
E# a 
43@ 492F 
E# 5 
Az 


i 1S49Q2EREREARSGSLSESOLSDES4 9685 9608DE0149A2G0EDGG01BCHN4SCRQCED 
iS LSS491.AEREREARSSIDGEO1 BS B6BCHN4 7 9DHe4 7 9e895GGESDHESEREHEARRDS 5 


i; BS49S2ECuadga1ss 


oe A 
STA A 
ACC #0 
STA suncnceece 
LDA A 

Figure 2 


Errors-Only Listing 


Figure 3 
Object Tape Listing 
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Assembly Errors 


The following descriptions of assembly errors and their possible causes 


> 


are provided to facilitate elimination of these errors in an assembly. 
1. A, X, Y, S AND P ARE RESERVED NAMES 


One of these reserved names was found in the label field. No 

code is generated for a statement with a reserved name as a label. 
Use of a reserved name in an expression will give an "undefined 
label" error, error 18. 


3. ADDRESS NOT VALID 
An address greater than 65535 (hex FFFF) was encountered. 
4, FORWARD REFERENCE IN EQUATE, ORIGIN OR RESERVE DIRECTIVE 


An expression used in one of these directives includes a label 
that hasn't been previously defined in the assembly source file. 


5. ILLEGAL OPERAND TYPE FOR THIS INSTRUCTION 


An operand was found which is not defined for the specified 
instruction opcode. Refer to Table 1 for the defined instruction 
addressing modes. 


6. ILLEGAL OR MISSING OPCODE 


A defined opcode was not found. Refer to Table 1 for the defined 
opcodes. 


7. INVALID EXPRESSION 


An expression was found that is not a valid sequence of numerical 
constants and/or labels separated by valid operators or is not a 
valid instruction operand form. 


8. INVALID INDEX - MUST BE X OR Y 


An indexable instruction was found with an invalid index. 
Refer to Table 1. 


9. LABEL DOESN'T BEGIN WITH ALPHABETIC CHARACTER 
A non-alphabetic character was encountered where a label was expected. 
10. LABEL GREATER THAN SIX CHARACTERS 
A string of more than six valid label characters (A-Z, 9-9, $, ., 
:) was found before a non-valid label character. This is a warning 


message. Assembly continues using the first six characters of the 
label. 
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LABEL PREVIOUSLY DEFINED 


The identified label has previously occurred in the assembler source 
file or this occurrence of the label had a different value on pass 
one than on pass two. The latter error may be caused by previous 
errors in the assembly. 


OUT OF BOUNDS ON INDIRECT ADDRESSING 


An indirect-indexed or indexed-indirect address does not fall into 
page zero as required. 


RAN OFF END OF LINE 
An operand is required and wasn't found before the end of the line. 
RELATIVE BRANCH OUT OF RANGE 


The target address of a branch instruction is farther away then the 
minus 128 to plus 127 byte range of the instruction permits. 


UNDEFINED LABEL 


The identified label is not defined anywhere within the assembler 
source file. 


FORWARD REFERENCE TO PAGE ZERO MEMORY 


This warning message is generated when an instruction that has both 
page zero and absolute addressing modes has an operand that is de- 
fined later in the assembly source file to be a page zero address. 
During pass one of the assembly two bytes are allocated for the 
Operand since its value is not yet known. Then during pass two 

the operand is found to require only a single byte so one byte 

is wasted. This is usually not a serious error because the generated 
code will generally execute as expected. 


IMMEDIATE OPERAND GREATER THAN 255 


An immediate operand expression evaluated to greater than 255, the 
maximum value that can be represented in a single byte immediate 
operand. 


LABEL (SYMBOL) TABLE OVERFLOW 


The size of the work space is insufficient to hold the current 
source file and a table for all of the labels encountered in the 
program. To assemble will require a reduction in either the size 
of the program source file or the number of symbols or an increase 
in the size of the work space. 
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Editor Commands 


Editor Operation 


The Editor provides a very easy to use means for creating assembly 
language source files and for editing, correcting, printing and punching a 
tape copy of the created file. The Editor is general purpose in that it is 
well-suited for creation of any type of source file whether it be assembly 


language, BASIC, another computer language or other form of printed docu- 


clears any entered source lines from memory. To prevent in- 
advertently clearing the work space, the question "INIZ?(Y/N)" 
is asked after the INIZ command has been entered. The user 
must enter "YES" (or simply "Y") to complete the initializa- 


tion operation. 


(line number)(any text) 


enters a source line. The line is placed into the source file 

at the position indicated by the specified line number. If a 
line number of zero (@) is entered, the line is placed immediate- 
ly after the previously entered line unless another command has 
been executed in the interim. If a zero numbered line is entered 
after the execution of a PRINT command, the line will be placed 
after the last line referenced by that command. Line numbers may 
be 1 through 65535. 

resequences all line numbers in the source file by 10, starting 
with 10. After the RESEQ command has been executed, the next 


sequential line number is output. 


DELETE (line specification) 


deletes the specified lines from the source file. The (line 


specification) may take any of the following forms: 


-18- 


first line = last Tine deletes the specified lines 


first line - deletes first line through the end 
- last line deletes from the start through last line 
line deletes the specified line 


PRINT (optional line specification) 


prints the specified lines in order by line number. The (line 


specification) may take any of the forms listed above for DELETE 


or may be omitted in which case all lines in the source file 
-are printed. 
In the PRINT and DELETE commands any number of line specifications, 


Spearated by commas may be entered after the command. 


All commands can be abbreviated down to their first letter. All commands 


and source lines must be followed by a carriage return. 

When entering commands or source text lines, corrections for typing 
errors can be made to a line anytime before the final carriage return is 
entered. An up-arrow character may be used to delete all characters so far 
entered on the line and a back-arrow may be used to successively delete pre- 
viously entered single characters, one back-arrow for each character to be 
deleted. 


Note: Up-arrow may be |, A or shift/N; back-arrow may be _ or shift/0 
on your keyboard. 


If an uninterpretable command is input, an explanatory error message is 
output with a pointer to the specific part of the command which could not be 
interpreted. When such an error occurs, any correct commands that appeared 
on the line previous to the erroneous command have been completed; those 


after the point of the error were not. 
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Assembler/Editor Statistics 


Source File Storage Requirements (per line): 
two bytes for the line number plus, 
one byte for each text character plus, 
one byte for the line terminator character (QD) 
All repeated characters such as a sequence of spaces, occupy only two 
bytes; one for the character and one for a repeat count. 
Symbol Table Storage Requirements: 
Six bytes/symbol. 6500 opcodes and reserved names occupy no symbol 
table space. 
Assembly Speed: 


Approximately 600 lines per minute. 
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Appendix A 
QOS-65D V3.0 Version 
of the 
6500 Assembler/Editor 


In 0S-65D V3.0, the Assembler/Editor is loaded from disk and initiated 


by typing ASM after the A* prompter in the DOS kernel command mode. 


Whenever 


exiting to the DOS, you can return to the Assembler/Editor as long as it is 


loaded by typing RETURN ASM. 


This version of the 6500 Assembler/Editor contains the following commands 


in addition to those described elsewhere in this manual. 


EXIT 


Hnnnn 


Mnnnn 


Control-I 


Control-C 


exits the Assembler/Editor and transfers control to the 
QS-65D kernel which then displays the A* prompter. 


sets the high memory limit to hexidecimal address nnnn. 


sets the memory offset for A3 assemblies to hexidecimal 
nnnn. 7 


tabs 8 spaces from the current print position. Also: 


Control-U 7 spaces 
Control-Y 6 spaces 
Control-T 5 spaces 
Control-R 4 spaces 
Control-E 3 spaces 


aborts the current operation. 


- command line sends the command line to OS-65D to be executed then 


returns to the Assembler. 


This version of the Assembler/Editor occupies memory from 0299 through 16FF. 


Its work space starts at 3179 (3279 in mini-floppy versions) and is utilized 


as shown below: 


S179,317A 
SL/B,o17C 
317D 
317E 


address of start of source (low, high) - nérmally 317E 
address of end of source +1 (low, high) 

number of tracks required for source 

normal start of source 


Note: It is possible to carry the Assembler's symbol table forward from one 
assembly to another. To do so, exit the Assembler after the first assembly 


A-1 


and enter the machine language monitor by typing "RE M". Change location 
9855 from YA to 18 and read out the contents of locations QP—A and PPPB. 

Enter the values from these locations into locations 12FA and 12FB, respective- 
ly. Then re-enter the Assembler by re-entering the DOS kernel at 2A51 and 
typing "RE A". Now the symbols from the first assembly will remain in the 
symbol table for reference during the next assembly. Likewise, the symbols 
from the first and second assemblies will remain for the third assembly, etc. 
If you want to eliminate all but the symbols from the first assembly, exit 
the Assembler and immediately re-enter it by typing "RE A". To restore normal 
operation of the Assembler change location 9855 back to QA. This will cause 
the symbol table to be cleared at the beginning of each assembly. 
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Appendix B 
Word Processor WP-1B Version 
of the 
6500 Assembler/Editor 


The WP-1B diskette boots up with the following message: 

OSI 6500/6800 SOFTWARE DEVELOPMENT SYSTEM VERSION 1.0 

MEMORY SIZE? 

Enter the memory size in decimal or hexidecimal preceeded by a $ or 
just hit the return key and all available memory will be used. The 
system then displays: 

SELECT ASSEMBLY: 


A. 6500 
B. 6800 


Type an A to select the 6500 Assembler/Editor or a B to select the 6800 
Assembler which uses the same Editor. Instructions for use of the 6800 
Assembler are provided in a separate manual. 

This version of the 6500 Assembler/Editor contains many enhanced Editor 
commands as described in the Ohio Scientific Word Processor Manual. The section 
of that manual entitled "Extended Features for Advanced Programming Topics" 
also applies with the exception that BASIC is not included. 

The disk operating system which can be entered by typing "EXIT" contains 


the following additional command of use to the 6800 Assembler user: 


Xnnnn_ switch to the 6800 processor and transfer control to hexidecimal 
location nnnn. 


The system also includes indirect file capability. 
Using Indirect Files 

Often it is desirable to be able to merge two or more assembler source 
files. The indirect file provides a mechanism for doing this. | 

In order to use an indirect file, you must have enough RAM to hold the 


required program(s) in the Assembler work space and another copy of the program(s) 


above the work space. The top of the work space can be appropriately set up 
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with the DOS Hnnnn command. Then the indirect file mechanism is set up 


with this address +] by entering it into the following location: 


» 


91A2 indirect file input address (high) - normally = 80 
The low part of this address is fixed at Qf. 


Transfers to and from the indirect file are then performed as follows: 


Dumping Source from the Work Space to an Indirect File 


1. Load the source into the Assembler work space with the LOAD command. 


2. Output the source but type a [ after typing PRINT and before hitting 
the RETURN key. This turns the indirect file output on. 


3. At the completion of the output type a]. This will be echoed as ]] 
and will turn the indirect file output off. 


Loading Source from an Indirect File to the Work Space 


1. Clear the work space by typing INIZ then YES. Or, load the source 
file into the work space into which the indirect file is to be 
merged. 


2. Type a Control-X and hit the RETURN key. The indirect file data will 
be loaded into the work space. When the ] character is input at the 
end of the file, the indirect file input will be terminated and you 
can containue with editing or assembly. | 


@ 


Note: It is possible to carry the Assembler's symbol table forward from one 
assembly to another. To do so, exit the Assembler after the first assembly 

and enter the machine language monitor by typing "RM". Change location 9855 
from @A to 18 and read out the contents of locations APPA and POPB. Enter 

the values from these locations into locations 12FA and 12FB, respectively. 
Then re-enter the Assembler by re-entering the DOS at 2599 and typing "RA". 

Now the symbols from the first assembly will remain in the symbol table for 
reference during the next assembly. Likewise, the symbols from the first and 
second assemblies will remain for the third, etc. If you want to eliminate 

all but the symbols from the first assembly, exit the Assembler and immediately 
re-enter it by typing "RA". To restore normal operation of the Assembler 
change location 855 back to MA. This will cause the symbol table to be cleared 
at the beginning-of each assembly. 
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Appendix C 
C2P - 1P Cassette Version 


of the 


> 


6500 Assembler/Editor 


This version of the Assembler/Editor is supplied on an auto-load 
cassette tape. The following procedure may be used to load the Assembler 
from tape: 


Loading the Assembler/Editor 


1. Apply power to your personal computer then reset it by pressing 
the break key. Load the cassette, label up, into the cassette 
machine and turn the cassette machine on with the volume at 
about mid-range. 


2. Type "ML". 


The M initiates the 65VP monitor and the L starts the auto-load. 

In a few seconds the four zeros in the upper left portion of the 
video monitor should change to an incrementing address value with 

a rapidly changing data field. The value of the address is depend- 
ent on which auto-load cassette is being read. At this time a check- 
sum loader is being read into memory in 65VP format. Upon completion 
(no more than 30 seconds), the checksum loader will load the rest of 
of the cassette. The Assembler comes up with the message INIZ?(Y/N). 


Should a checksum error occur, the following message is printed: 


OBJECT LOAD CHECKSUM ERR 
REWIND PAST ERR - TYPE G TO RESTART 


If a checksum error consistently happens at the same location, the cassette 
is probably bad - contact your OSI dealer concerning replacement. However, 
should checksum errors occur randomly at various locations, it is most likely 
that there is a problem with the cassette machine or the connection to the 
computer. Check for broken or frayed connections. Make sure that the play- 
back head and pressure roller/capstan assembly is clean. With a minimal 
amount of care, no problems with auto-load cassettes should be encountered. 


The cassette version of the Assembler/Editor permits loading and saving 
source code in a manner similar to ROM BASIC. 
To save source code: 


Type SAVE (CR); type PRINT (line specification), turn on the cassette 
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machine in record mode and type (CR). As in ROM BASIC, the save mode is 
disabled by typing LOAD (CR) followed by a space. 
To load previously recorded source code: 


Turn on cassette machine in play; type load, wait for leader to pass, 
they type (CR). The LOAD mode is disabled by typing a space. 


This version of the Assembler/Editor also provides the following 
commands : 


EXE causes the computer to execute its reset vector and display 
"C/W/M2?". Great care must be taken never to type "C" as 


this will destroy the Assembler/Editor. The Assembler/Editor 


may then be re-entered by typing "M 1299 G". 
CONTROL-I tabs 8 spaces from the current cursor location. 


The above commands, as all other Assembler/Editor commands may be executed 
by typing the first letter only. 


This version of the Assembler/Editor occupies memory from $249 through 
1399 (hexidecimal) and requires a minimum total of 8K of memory to operate. 
Its source file work space starts at 1391 and ends at IFFF, as supplied. 
The entry location is hex 1309. While running all of page zero is used. 
However, you can exit the Assembler/Editor, use page zero and re-enter it by 
typing "M 1399 G". 

The following locations may be changed in the cassette version of the 
Assembler/Editor to suit your requirements: 

12C9,12CA the low, high memory address of the start of the source file 

work space. 1391 hex, as supplied. 


12CB,12CC the low, high memory address of the end of the source file 
work space. I1FFF, as supplied. 


12FC,12FD the low, high memory offset used to bias placement of object 


code during an A3 assembly. @, as supplied. 

12FE,12FF the low, high address of the next available source file 
storage location. These locations are initialized to the 
address of the start of the work space by the INIZ command 
and, thereafter, are automatically updated by the Editor. 


Note: It is possible to carry the Assembler's symbol table forward from one 
assembly to another. To do so, exit the Assembler after the first assembly 
and enter the machine language monitor by "M". Change location $855 from 

A to 18 and read out the contents of locations PPPA and PPPB. Enter the 
values from those locations into locations 12FA and 12FB, respectively. 
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Then re-enter the Assembler by typing ".1309G". Now the symbols from the 
first assembly will remain in the symbol table for reference during the 
next assembly. Likewise, the symbols from the first and second assemblies 
will remain for the third assembly, etc. If you want to eliminate all but 
the symbols from the first assembly, exit the Assembler and immediately re- 
enter it by typing "M13Q~G". To restore normal operation of the Assembler 
change location 9855 back to PA. This will cause the symbol table to be 
cleared at the beginning of each assembly. 
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